home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / toflop30.zip / TOFLOPPY.DOC < prev    next >
Text File  |  1993-02-14  |  15KB  |  333 lines
  1.  
  2.  
  3. ▄██████████▄  ▄███████▄        Version  0.30 ßeta Test
  4. ▀▀▀▀████▀▀▀▀ ████▀▀▀████        ≡ WAR GAMES SOFTWARE ≡
  5.     ████     ███     ███           Made in BELGIUM
  6.     ████     ███     ███
  7.     ████     ████▄▄▄████
  8.     ▀██▀      ▀███████▀ 
  9.  
  10.  
  11.       (C) Copyright WAR GAMES SOFTWARE 1992,1993
  12.  
  13.  
  14. ▄█████████▄ ▄██▄         ▄███████▄  ▄████████▄  ▄████████▄  ▄██▄   ▄██▄
  15. ████    ▀▀▀ ████        ████▀▀▀████ ███▀   ▀███ ███▀   ▀███ ▀████▄████▀
  16. ████▄▄▄▄    ████        ███     ███ ███▄   ▄███ ███▄   ▄███   ▀█████▀
  17. ████▀▀▀▀    ████        ███     ███ █████████▀  █████████▀      ███  
  18. ████        ████▄▄▄▄▄▄▄ ████▄▄▄████ ████        ████            ███  
  19. ▀██▀         ▀████████▀  ▀███████▀  ▀██▀        ▀██▀            ▀█▀  
  20.  
  21.  
  22. ┌──────────────────────────────────────────────────────────────────────────┐
  23. │ ▓▓▓▓ FLOPPY REQUEST DOOR PROGRAM 0.30 ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  24. └──────────────────────────────────────────────────────────────────────────┘
  25.         Some time ago another sysop asked me if I could write a program
  26.         that lets the users the possibility of tagging files to be copied
  27.         to a floppy disk to be send by mail !
  28.         Well this is it.
  29.  
  30.         The door will thru a couple of menu's and questions create
  31.         Batch files that the sysop has to execute to produce the floppies
  32.         asked by the users !
  33.  
  34. ┌──────────────────────────────────────────────────────────────────────────┐
  35. │ ▓▓▓▓ WORKING MECANISM OF THE DOOR ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  36. └──────────────────────────────────────────────────────────────────────────┘
  37.         
  38.         First of all the user should execute the first option to
  39.         select the media and to give the address where to send the floppies.
  40.         After that he is able to select the area and to tag files with the 
  41.         appropriate menu options.
  42.         With the View statistics option he will see how many money to pay 
  43.         for the demanded floppies and also the bank account where to leave
  44.         the money on.
  45.         Once the sysop recieves the ammount for this user he can use the
  46.         generated batch file to copy all selected files to floppies.
  47.         The program tracks floppy capacity when showing the file list
  48.         so if you select 360 Kb floppies files bigger than that will be 
  49.         shown as TO BIG in the tag menu.
  50.         If the floppy is full the needed batch file lines are appended
  51.         in it to let the sysop swap from floppy.
  52.         All needed info for mailing is also copied in the batch file.
  53.         A sysop log file is keeped with all the info on all tag batch files
  54.  
  55. ┌──────────────────────────────────────────────────────────────────────────┐
  56. │ ▓▓▓▓ INSTALLATION PROCEDURE ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  57. └──────────────────────────────────────────────────────────────────────────┘
  58.         Create a directory and unpack all file of the archive in it.
  59.         Edit your AUTOEXEC.BAT file and add the line
  60.  
  61.                 SET TOFLOPPY=C:\SUPERBBS\TOFLOPPY
  62.  
  63.         or wathever you have called the directory !
  64.  
  65.         Now just do a shell and give the name of your system info
  66.         file !
  67.  
  68.         This door has been devloped for SuperBBS especialy
  69.         but can be used for :
  70.  
  71.  
  72.         Possible supports are :                BBS info file to specify:
  73.  
  74.         PCBOARD                Proboard.sys
  75.         WILDCAT                Callinfo.bbs
  76.         SPITFIRE            Door.sys
  77.         RBBS-PC                       Dorinfox.def 
  78.         QUICKBBS            Dorinfox.def
  79. *               REMOTE ACCESS                   Dorinfox.def
  80.         MBBS                Generic.sys
  81. *               SUPERBBS                        Dorinfox.def
  82.  
  83.         Only tested with * for exitinfo.bbs updates !
  84.         all the other bbs emulation works but without the user update !
  85.  
  86.         In the case of SuperBBS or Remote Access
  87.  
  88.         Menu Option : 7 
  89.                 Option Data : YOURDIR\TOFLOPPY.EXE DORINFO*N.DEF *E *S
  90.  
  91.                 *N gives the node number
  92.                 *E rereads the exitinfo file
  93.                 *S swaps bbs to ram .
  94.  
  95. ┌──────────────────────────────────────────────────────────────────────────┐
  96. │ ▓▓▓▓ FLSEARCH.CTL FILE GENERATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  97. └──────────────────────────────────────────────────────────────────────────┘
  98.  
  99.         For the door to work you MUST have a FLSEARCH.CTL file that 
  100.         contains the info of your areas that can be used by the program
  101.         Under SuperBBS this file can very easely be created wif the command:
  102.  
  103.         SBBSUTIL FLSEARCH
  104.  
  105.         Under other BBS softwares you should make it by yourself or find
  106.         an utility that can do the job for you.
  107.         If you can not find it you have to edit it be yourself like this
  108.  
  109.         Every line in this ascii file defines 1 area :
  110.  
  111.         C:\FILES\ARCHIVERS 20 General_Archivers_Programs
  112.  
  113.         Like you see there are 3 parts on the line
  114.         1: First the PATHNAME of the area where is all files are and where
  115.                 the files.bbs file is also !
  116.         2: The security level to access the area.
  117.         3: A text line that descripes the area with underscores in place
  118.                 of spaces.
  119.  
  120.         
  121.  
  122. ┌──────────────────────────────────────────────────────────────────────────┐
  123. │ ▓▓▓▓ CONFIG FILE INORMATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  124. └──────────────────────────────────────────────────────────────────────────┘
  125.  
  126.         Many options can be changed in the TOFLOPPY.CFG file 
  127.         located in the TOFLOPPY directory.
  128.         The system works with defaults if no keywords are found in it.
  129.         You must leave the keyword exactly like they have been setup.
  130.         If you change the syntax of the keywords they can't be found by 
  131.         the program!
  132.  
  133.  
  134.  
  135.         BATCH_FILES : The Pathname of the directory where the batch files
  136.                       should be placed
  137.         
  138.         SELECTED_FILES  5,32   : Where the program can write the number of
  139.                                  selected files (row,column).
  140.  
  141.         NUMBER_BYTES    6,32   : Where the program can write the total
  142.                                  number of bytes tagged (row,column).
  143.         
  144.         FLOPPIES        5,67   : Same for floppy quantity.
  145.  
  146.         CURRENT_AREA    4,12   : Same for current area.
  147.  
  148.         FREE_BYTES      6,67   : Same for the number of free bytes 
  149.                                  on the last floppy disk.
  150.  
  151.         MEDIA_TYPE      4,67   : Same for the type of media the user 
  152.                                  has chosen for.
  153.  
  154.         PROMPT_POSITION 16,30  : Where the cursor should be placed
  155.                                  to wait for a command in the main menu.
  156.  
  157.  
  158.         TOO_BIG_STRING     __FILE_TOO_BIG____
  159.         LOST_FILE_STRING   __LOST_IN_SPACE___
  160.  
  161.                                : These strings could be changed if you want too
  162.                                  Spaces MUST be substituted by underscores
  163.                                  Only the 18 first characters are taken !
  164.  
  165.         DATE_FORMAT        DMY : Date format you want to use in
  166.                                  the files listing
  167.                                  Only MDY or DMY are accepted !
  168.         
  169.         COLORS 3,14,4,11,12,9,10,13,2,5
  170.  
  171.                                 Parameters :
  172.  
  173.                                 : 1 & 2 normal text low and highligthed
  174.                                 : 3 & 4 Prompts      "   "   "
  175.                                 : 5 & 7 Menu and tag option screens
  176.                                 : 6 End of listing line
  177.                                 : 8 Info edition color change
  178.                                 : 9 Statistics screen
  179.                                 : 10 Info edit highlite color
  180.  
  181.         The colors are some what mixed up but with 2 or 3 modifications 
  182.         you can get them like you want it !
  183.                                         
  184.              colors for the internal strings
  185.              
  186.             dkblue          1      dkgrey          8      
  187.             dkgreen         2      blue            9      
  188.             dkcyan          3      green           10     
  189.             dkred           4      cyan            11     
  190.             dkviolet        5      red             12     
  191.             magenta         5      violet          13     
  192.             brown           6      yellow          14     
  193.             grey            7      white           15     
  194.                                                                                
  195.                                
  196.         MAIN_MENU_KEYS  SLCEV* : Main menu keys you want to use for
  197.                                  your configuration
  198.  
  199.                         Character number        Option
  200.                                 1                Info input
  201.                                 2                List area        
  202.                                 3                Change from area
  203.                                 4                Edit tagged list
  204.                                 5                View statistics
  205.                                 6                Quit to BBS
  206.  
  207.                                                                                                
  208.         PRICE_720       150    : Prices for floppies.
  209.         PRICE_1440      150    
  210.         PRICE_1220      180     
  211.         PRICE_360       60      
  212.  
  213.  
  214.         POSTAGE_COSTS   100     : Aditional postage costs
  215.  
  216.         BANK_ACCOUNT    XXX-XXXXXXX-XX : bank account number for payements
  217.  
  218.         CURRENCY        BEF : or any string up to 15 characters that
  219.                               defines your payement currency
  220.  
  221.         COPY_ECHO       ON  : ON or OFF add >NUL: on the batch copy file
  222.                               lines to surpress output if wanted !
  223.  
  224.         The last line containing the word END must be there or 
  225.         the door will hang.
  226.  
  227.         WARNING :
  228.         If you change the menu files you should take care of some rules:
  229.  
  230.         1: Never make a main menu longer than 23 lines or your alignment
  231.            becomes false!
  232.  
  233.         2: Let enough place for the parameters that the program writes
  234.            directly on the screen.
  235.  
  236.         3: The TOFLHEAD file may not be longer than 3 lines !!!!
  237.  
  238.  
  239.         A good practice is to edit the ansi files with your favorid
  240.         editor after creating them and to remove the lines or ansi commands
  241.         that makes it longer than 3 for HEAD or 23 lines for MAIN !
  242.  
  243.  
  244. ┌──────────────────────────────────────────────────────────────────────────┐
  245. │ ▓▓▓▓ LOGGING FEATURES FOR SUPERBBS AND REMOTE ACCESS ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  246. └──────────────────────────────────────────────────────────────────────────┘
  247.  
  248.         If you are running Remote Access or SuperBBS 
  249.     the door will look at the RA or SBBS environment variable
  250.     and setup a logfile by default !
  251.         This is for RA  -> Contents of the RA variable plus \RA.LOG
  252.         This is for SBBS-> Contents of the SBBS variable plus \SYSTEM.LOG
  253.  
  254. ┌──────────────────────────────────────────────────────────────────────────┐
  255. │ ▓▓▓▓ FILE'S THAT CHANGES THE CONFIGURATION ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  256. └──────────────────────────────────────────────────────────────────────────┘
  257.  
  258.     TOFLHEAD.A?? :  That's an ANSI or ASCII file shown just above your
  259.                     menu.  Be sure to leave enough place for your menu and 
  260.                     other information! ( Really only 3 lines !!! )
  261.  
  262.     TOFLMAIN.A?? :  This ANSI/ASCII must be present for the Main menu.
  263.                     You need to modify also the config file if you
  264.                     placed the info written on this screen on another place.
  265.                     The TOFLHEAD.A?? will still be used for the other
  266.                     screens.
  267.  
  268. ┌──────────────────────────────────────────────────────────────────────────┐
  269. │ ▓▓▓▓ REGISTRATION AND OTHER STUFF ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  270. └──────────────────────────────────────────────────────────────────────────┘
  271.  
  272.     There are 2 way's to register this door
  273.  
  274.                 1: 10$ Registration
  275.  
  276.                    If you send me 10$ and you give me a FIDONET number
  277.                    where I can send you netmail I will leave you a
  278.                    message with your Standard registration key.
  279.            In this case you will have the publicity for my doors
  280.            when starting the program and telling to who it is
  281.            registered !
  282.                    Timedelay is surpressed on exit when registered !
  283.             
  284.                 2: 30$ Commercial Registration
  285.  
  286.                    In this case you recieve another key that enables all the 
  287.                    first registration features but will disable also 
  288.                    all publicity logon screens!
  289.            In this case I will send the key to you be any way
  290.                    Netmail or by SNAILMAIL !
  291.  
  292. ┌──────────────────────────────────────────────────────────────────────────┐
  293. │ ▓▓▓▓ CREDITS ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  294. └──────────────────────────────────────────────────────────────────────────┘
  295.  
  296.         This door uses the CKIT Door Building Library by Rickie W. Belitz
  297.         Distributed by Data-Comp Information Systems P.O. Box 5895
  298.         Maryville , Tennesie 37802-5895.
  299.         Who was a great help for me ! Thanks Rickie !
  300.         PS: he will be mad because i don't have mentionned all his
  301.         stuff for compatibility on other bbs systems ! and fossil etc ....
  302.  
  303.         So you can refer to the doc of this library to look at the
  304.         possible bbs software supported and options !
  305.  
  306.         SuperBBS is a trademark of Aki Antman
  307.         Remote Access is copyright (c)  Andrew Miller
  308.  
  309.         
  310. ┌──────────────────────────────────────────────────────────────────────────┐
  311. │ ▓▓▓▓ WAR GAMES SOFTWARE SUPPORT ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  312. └──────────────────────────────────────────────────────────────────────────┘
  313.  
  314.     To contact the author or to register this program call:
  315.  
  316.                    Marc Buffet
  317.                                Waverse Steenweg 1002
  318.                                B-1160 Brussels
  319.                                Belgium
  320.                                Europe
  321.  
  322.                                WOPR'S BBS
  323.                                Home of the WAR GAMES SOFTWARE
  324.                                +32-2-736.63.47 (CM)
  325.                    1200-14.400 8N1 
  326.                    or leave a message at     
  327.                                2:291/725@Fidonet.org
  328.                                22:200/11@WalNet
  329.                                52:32/0@OasisNet  
  330.  
  331.         
  332.  
  333.